Skip to content

docs: clarify core vs optional workflows and add MCP-server variations to ci-cd.md#61

Merged
TMHSDigital merged 2 commits into
mainfrom
docs/clarify-workflow-standard
May 23, 2026
Merged

docs: clarify core vs optional workflows and add MCP-server variations to ci-cd.md#61
TMHSDigital merged 2 commits into
mainfrom
docs/clarify-workflow-standard

Conversation

@TMHSDigital
Copy link
Copy Markdown
Owner

Summary

  • Removes pages.yml from the required core workflow list; it is generated by the scaffold by default but is not required for every repo type.
  • Adds drift-check.yml as the third required core workflow (alongside validate.yml, release.yml, and stale.yml), matching what all nine tool repos already have.
  • Adds pages.yml and label-sync.yml to the optional workflows table with explicit notes that the scaffold generates them by default.
  • Adds a new ## MCP-server Variations section documenting that MCP-server repos substitute publish.yml for release.yml, may omit pages.yml, may omit plugin-manifest validation checks in validate.yml (no plugin.json), and still require drift-check.yml and stale.yml.

Motivation

The prior drift audit found that ci-cd.md, the scaffold output, and the drift checker disagreed about which workflows are required. The scaffold generates label-sync.yml and pages.yml by default, but neither the standard nor the checker treated them as required. drift-check.yml is present in all nine tool repos but was not listed in ci-cd.md at all. This PR makes the standard authoritative.

Version note

This is a docs: commit; CI does not require a VERSION bump. However, this change settles a surface-level ambiguity in the standards and is exactly the kind of clarification that standards/versioning.md describes as warranting a MINOR bump and a re-alignment rollout. Deferring that decision to the maintainer. If you decide a MINOR bump is warranted, bump VERSION in a follow-up chore: commit on this branch before merging, or open a separate PR after this lands.

Test plan

  • python scripts/sync_from_registry.py --check exits 0
  • No em/en dashes in the edited file
  • CI validate, sync-check, safety-scan must pass

Co-Authored-By: Claude Sonnet 4.6 noreply@anthropic.com

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 23, 2026

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

…s to ci-cd.md

Signed-off-by: fOuttaMyPaint <154358121+TMHSDigital@users.noreply.github.com>
The MCP-server Variations section opened with "follow the same core
requirement as cursor-plugin repos," implying validate.yml was required.
It is not. All validate.yml checks assume plugin.json; mcp-server repos
have no plugin.json.

Rewrites the section to state the three required workflows explicitly
(drift-check.yml, stale.yml, publish.yml) and explains why validate.yml
is absent. Also updates the doc intro to distinguish cursor-plugin (four
required) from mcp-server (three required).

This brings the prose into exact agreement with the machine-readable
config in standards/drift-checker.config.json.

Signed-off-by: fOuttaMyPaint <tmhospitalitystrategies@gmail.com>
Signed-off-by: fOuttaMyPaint <154358121+TMHSDigital@users.noreply.github.com>
@TMHSDigital TMHSDigital force-pushed the docs/clarify-workflow-standard branch from 7f39642 to 9966ab9 Compare May 23, 2026 23:53
@TMHSDigital TMHSDigital merged commit 063e150 into main May 23, 2026
13 checks passed
@TMHSDigital TMHSDigital deleted the docs/clarify-workflow-standard branch May 23, 2026 23:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant